home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 18 / AMIGAplus Sonderheft 18 (1999)(ICP)(DE)[!].iso / PD / Anwendungen / AmigaEYE / AmigaEYE.doc < prev    next >
Text File  |  1999-01-03  |  20KB  |  361 lines
  1.                                              _   _
  2.                                             / \ / \
  3.                                             \#/ \#/
  4.            _              _                    _      _             _
  5.           /(\  Version:  /(\     _            /(\    /(\           /(\
  6.          /  \    39.7   /  \    /(\          /  \   /  \          /  \
  7.         /    \         /    \  /  \         /    \ /    \___     /    \
  8.        /      \       /      \/    \       /     //     ___ \   /      \
  9.       /        \     /              \     /     //     /\__\ \ /        \
  10.      /          \   /                \   /     //     / /   )//          \
  11.     /     /\     \ /     /\    /\     \ /     //     / /    \/     /\     \
  12.    /     /__\    //     / /\  / /\    //     //     / /______\    /__\     \
  13.   /     ____    //     / /  \/ / /   //     //     / / _     \\    ____     \
  14.  /     /\__/   //     / /    \/ /   //     / \    ( /\( \    /\\   \___\     \
  15.  \    ( / (___/ \    ( /       (___/ \    ( / \    V  \\/   / / \___)\  )    /\
  16.   \    V   \__\/ \    V         \__\/ \    V   \    \__7   / /   \__\/ /    / /
  17.    \___/\         \___/\               \___/\   \_________/ /          \___/ /
  18.     \__\/  sMail:  \__\/     eMail:     \__\/    \________\/            \__\/
  19.                                                            _______  ___ _____
  20.   Christian Krapp      Christian.Krapp@A-City.De          / __//\ \/ /// __//
  21.   Hagenmähderstr.9                                       / _//   \  /// _//
  22. D-86391 Stadtbergen                                     / //__   / /// //__
  23.   (GERMANY)                                             \___//  /_// \___//
  24.                                                © 1995-1999 by Christian Krapp
  25.                                                     Released as SHAREWARE
  26.     http://www.a-city.de/homepages/ba044406/
  27.  
  28.              An AugustA team Release!
  29. --------------------------------------------------------------------------------
  30.  
  31. Copyright:
  32.   This program and all accompanying files (program-icon) are copyrighted 1995-99
  33. by Christian 'cr8y' Krapp! You can  copy these  files to your friends as long as
  34. the files are unchanged. It is not allowed to demand a fee higher as media costs
  35. and a (little) copy-fee. In addition, no one is allowed to put these  files onto
  36. a PD-disk or an CD-Rom. You can get a permittion by the author. Please contact!
  37.  
  38. For the AmiNet, FreshFish and MeetingPearls CD-Rom's is no permittion requiered!
  39.  
  40.   This  program is Shareware. Everyone, who use this program, should register it
  41. by  sending me  the registration  fee (see below). The shareware  fee is  5,- DM
  42. plus postage. 
  43.  
  44.   When you use this little program, than you use it on your own risk! The author
  45. take no respons for damage made by AmigaEYE!
  46.  
  47. --------------------------------------------------------------------------------
  48.  
  49. What is it?
  50.   Do you know these funny Eye-programs, which follow the mouse-pointer! Ok. Than
  51. you know AmigaEYE. It's an Eye-program for an upstyled Workbench.
  52.   The first lines of code are written back in 1995 and were released as MagicEYE
  53. Since that first work are more than 2 years gone by and so the program changed a
  54. lot  (not only  the Name and  the shareware fee). Look at the history at the end
  55. ;-)
  56.  
  57. --------------------------------------------------------------------------------
  58.  
  59. 15 reasons, why to use this program:
  60.  
  61.  1.) colorized eyes ;^)
  62.  2.) Eye-sets with different sizes
  63.  3.) automatic window close, when WB is closed (screennotify.library)
  64.  4.) you can configurate a lot
  65.  5.) patch to have an screen-drag MagicEYE-window
  66.  6.) More than 10(!) different eye-effects
  67.  7.) colorremapping, MagicWB nolonger needed (AmigaOS 3.0+)
  68.  8.) very short program
  69.  9.) it's an commodity
  70. 10.) can copy screen-background into MagicEYE-window
  71. 11.) MagicEYE-window is the hindmost window
  72. 12.) Eyes for different sizes
  73. 13.) Eyebrows
  74. 14.) Pirate eyes
  75. 15.) Eye glasses
  76.  
  77. --------------------------------------------------------------------------------
  78.  
  79. What do you need?
  80.   You need  of course an  Amiga-Computer  (or an compatible  one ;^) ). Also you
  81. need  at least AmigaOS 3.0. In addition to the OS you  should run your Workbench
  82. with at least 8 colors and a quadratic resolution (e.g. 640×512).  Last  but not
  83. least you should use a supported font size for screen title. And new for release
  84. 2 of AmigaEYE  you  need the screennotify-library from  Stefan Becker (optional,
  85. if you want automatic  close of the AmigaEYE-Window when WB close).
  86.  
  87. --------------------------------------------------------------------------------
  88.  
  89. How to install?
  90.   Nothing simpler than that: you copy only AmigaEYE to your  WBStartup-directory
  91. on  you  startvolume  (disk,  hd...)  and  the  files  in  the AmigaEYE/#?  into
  92. ENV:AmigaEYE/#?. In  addition to that do an reboot. That's it :-]
  93.   When you  want  to  run  your  User-Startup,  than  copy  AmigaEYE  into  your
  94. C-Directory, the AmigaEYE/#? files  into ENV:AmigaEYE/#?  and run  AmigaEYE from
  95. your User-Startup.
  96.  
  97. --------------------------------------------------------------------------------
  98.  
  99. How to use?
  100.   You can  run this program  from the Workbench (or the WBStartup directory) and
  101. from a Shell (User-Startup). You can specify the parameters in the icon as Tool-
  102. Types, as options in the shell or in a configuration file (ENVARC/AmigaEYE/CFG).
  103.  
  104.   DONOTWAIT       : This has nothing  to do with  AmigaEYE. It's only a flag for
  105.                     Workbench.
  106.   WIN_X           : Where  do you want to place  the AmigaEYE-window?  Here  you
  107.   WIN_Y             configurate  the x and y  position.  Default:  WIN_X=545 and
  108.                     WIN_Y=1
  109.                     ATTENTION: If  you use  an  titlefont smaller than 13 point,
  110.                     set the value of WIN_Y to 0.
  111.   PRIORITY        : Defines the task-priority.  This value should  be lower than
  112.                     0, so, other programs (which need the system-time) gets more
  113.                     system-time. The default value is 0 (program) or -5 (Icon).
  114.   MOVEABLE        : Window can be moved on the screen.
  115.   DRAGPATCH       : With  this (non system-friendly)  patch it  is possible,  to
  116.                     drag the  screen  with the  AmigaEYE-window.  So there is no
  117.                     different on  the screen-title,  when  you want to drag down
  118.                     the screen (funny). Default is off!
  119.   BACKGROUND      : Copy the background of the  position, where the Eyes appears
  120.                     into the AmigaEYE window (and so into the background).
  121.   QUICKQUIT       : Enable faster quitting of AmigaEYE (with right Mousebutton).
  122.   BACKDROP        : Enable the Layer  Patch,  that bring the  AmigaEYE window to
  123.                     the  hindmost  window  (every time!).  ATTENTION: with  this
  124.                     patch there will be the function BehindeLayer (-54) from the
  125.                     layer.library changed!
  126.   SLEEP_PERIOD    : This  flag define  the time (in sec)  that the program wait,
  127.                     till it close the Eyes, when the mouse isn't moved!
  128.                     Default: 5. (Try different values!)
  129.   SIZE            : Define the size of the graphic-set that is used. For a title
  130.                     font with the size 13  you need  to use  the  graphic-set 13
  131.                     (SIZE=13)! ATTENTION: At  this time there are only set's for
  132.                     the sizes 5, 11, 13, 16 and 26!
  133.                     If your specify 0 as your preferred size, than AmigaEYE look
  134.                     for the size of the title-font  and tries to open a graphic-
  135.                     set that is ok for that title-font. Doesn't exist that  set,
  136.                     AmigaEYE will quit!
  137.   NOANTIAL        : This flag should be set if you want to use the nonantialized
  138.                     graphic set - for better results  on screens with dark back-
  139.                     ground colors.
  140.   NOBROWS         : With  this ToolType  you can switch off the eyebrows. So you
  141.                     get  the  same behaviour of  AmigaEYE  as  in  the  previous
  142.                     versions. If you use the eyebrows, you should remember, that
  143.                     AmigaEYE opens a window that is a little bit larger than the
  144.                     window without eyebrows (e.g. you should use the graphic-set
  145.                     11 if you  have  a title-font  with 13 point and want to use
  146.                     eyebrows).
  147.   PUPILSDIFFERENT : You can use this ToolType, if you don't want to see the same
  148.                     pupile in the left and right eye.
  149.   MULTIRUN        : To run AmigaEYE  more than  once a time, you should use this
  150.                     option. So it is possible to start more than one eye-pair on
  151.                     the screen. This option can only be used without BACKDROP!!!
  152.   LIDCOLOR1       : With these ToolTypes you can change the color of the graphic
  153.   LIDCOLOR2         After the keyword you must give an hex-number:
  154.   BLOODCOLOR                                  RRGGBB
  155.   PUPILCOLOR1          RR - red (00 - FF)
  156.   PUPILCOLOR2          GG - green (00 - FF)
  157.   PUPILCOLOR3          BB - blue (00 - FF)
  158.   EYECOLOR1         
  159.   EYECOLOR2         So FFFFFF means the color white!
  160.   PUPILREDCOLOR1    ATTENTION: When  the new color-values  aren't used,  then it
  161.   PUPILREDCOLOR2               can  be, that  there  are no  free  colors on the
  162.   PUPILREDCOLOR3               screen.
  163.   BROWCOLOR1
  164.   BROWCOLOR2
  165.   BROWCOLOR3
  166.  
  167. And now the effect-configuration. Very  important to know: The values,  that you
  168. give here, are interpreted as a probability (1/value). The value must be greater
  169. than 1, an value of 0 means, that this effect isn't activ:
  170.  
  171.   SLEEPY            : This  value is  needed, to  define how often the  Eyes are
  172.                       closed. 
  173.   TIRED             : Define, how often the eye-lid's go down to the half.
  174.   ROLL_SYNCHRON     : When roll the Eye synchron (in same direction).
  175.   ROLL_ASYNCHRON    : When roll the Eye asynchron (in different direction).
  176.   LEFTRIGHT         : How often the Eye's look Left-Right.
  177.   UPDOWN            : How often the Eye's look Up-Down.
  178.   RANDOM_EYE        : Defines, when you get the trembling Eye's.
  179.   BLOODY            : When get the red Eye's?
  180.   CLEAR             : When should get the red Eye's get cleared?
  181.   LEFT_EYE          : Close left Eye. (depend on SLEEPY)
  182.   RIGHT_EYE         : Close right Eye. (depend on SLEEPY)
  183.   ANGRY             : Angry Eyes. (depend on SLEEPY)
  184.   ANXIOUS           : Anxious Eyes. (depend on SLEEPY)
  185.   INSULT            : Insult Eyes. (pupiles look in other direction)
  186.   STOP_TIRED        : When to stop the TIRED effect.
  187.   STOP_ANGRYANXIOUS : When to stop the angry and anxious eyes.
  188.   STOP_EFFEKT       : When to stop any effect.  If you put here an 0  the effect
  189.                       run endless.
  190.   PUPILNORMAL       : When should normal pupils appear.
  191.   PUPILBIG          : When should big pupils appear.
  192.   PUPILCROSS        : When should cross pupils appear.
  193.   PUPILAMIGA        : When should Amiga pupils appear.
  194.   PUPILHEART        : When should heart pupils appear.
  195.   PUPILGLASS        : When should glassy pupils appear.
  196.   PUPILCOLOR        : When should colorized pupils appear.
  197.   GLASSES           : When to show the eye-glasses.
  198.   GLASSES_NO        : When to remove the eye-glasses.
  199.   NORMALBROWS       : When to show the normal eye-brows.
  200.   ANGRYBROWS        : When to show the angry eye-brows.
  201.   PIRATE_BOTH       : When to show both pirate-eyes.
  202.   PIRATE_LEFT       : When to show the left pirate-eye.
  203.   PIRATE_RIGHT      : When to show the right pirate-eye.
  204.   PIRATE_NO         : When to show no pirate-eye.
  205.  
  206.   So, that's it.  You know now all the features  of AmigaEYE. Or...? You want to
  207. know, how to exit this mega mighty program? Is it true? Do you want to quit this
  208. program?  Ok. I see... You want  know  this (very stupied :-|) feature: There
  209. are two ways (argh... three ways):
  210. 1.) Run AmigaEYE again (only if MULTIRUN is switched off)!
  211. 2.) Run Exchange, select AmigaEYE and quit it!
  212. 3.) (when QUICKQUIT) Activate AmigaEYE-Window and press right Mousebutton!
  213.  
  214. --------------------------------------------------------------------------------
  215.  
  216. What can be made better?
  217.   * More funny things with the Eyes
  218.   * It is possible, that there exists errors (undocumented features ;^) or bugs)
  219.     which we doesn't want!
  220.  
  221. --------------------------------------------------------------------------------
  222.  
  223. Problem...
  224.   ...are possible  with AmigaEYE. When  you start AmigaEYE  and nothing  apears,
  225. than it  is possible, that the  additional-data-files aren't installed correctly
  226. or  that the wrong  version  is installed.  To avoid  this, copy  AmigaEYE/#? to
  227. ENVARC:AmigaEYE/#? and restart the computer. Copy only  files from that AmigaEYE
  228. Archive,  from that  you start  AmigaEYE-exe (It's  possible, that some parts of
  229. the additional-files are changed from time to time)!
  230.  
  231. --------------------------------------------------------------------------------
  232.  
  233. To register AmigaEYE (and bug-reports, new ideas) send a mail to:
  234.  
  235.                  sMail:           Christian Krapp
  236.                                   Hagenmähderstr. 9
  237.                                 D-86391 Stadtbergen
  238.                                   (GERMANY)
  239.                  eMail:           Christian.Krapp@Augsburg.BayNet.De
  240.  
  241.         Shareware fee :           5,- DM
  242.  
  243. --------------------------------------------------------------------------------
  244.  
  245. History:         (xx means 37 (AmigaOS 2.04) or 39 (AmigaOS 3.0+))
  246.         __       __
  247.         )\\     /((                                          __
  248.        /  \\   /  \\               __         ________      / \\     ________
  249.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  250.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  251.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  252.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  253.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  254.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  255. / // © 1995--1997 by \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  256. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  257.       sMail:                                               ________ ___ _____
  258.   Christian Krapp                 eMail:                  / __//\ \V /// __//
  259.   Hagenmähderstr.9       Christian.Krapp@A-City.De       / _//   \  /// _//
  260. D-86391 Stadtbergen                                     / //__   / /// //__
  261.   (GERMANY)                                             \___//  /_// \___//
  262.  
  263. Vxx.0   28.04.1995 - First try (produced MagicEYE-Animation).
  264. Vxx.1   16.06.1995 - After a long work it's done. The first public-version ok.
  265. Vxx.2   01.08.1995 - Silly error removed (Thanks Roland Fulde).
  266.                    - Colorizing implemented  (Markus Speicher and Mario Cattaneo
  267.                      were interessted, only 39.x-Version).
  268.                    - ScreenNotify-Library supported (Mario Cattaneo).
  269.                    - Rolling Eye (Dirk Wrocklage).
  270.                    - Tremble and red Eye's (Michael Krapp).
  271.                    - Rolling  Eye  asynchron,  tired  Eye  and  look  Left-Right
  272.                      (Christian Krapp)
  273. Vxx.3   01.03.1996 - ScreenNotify-Library optional!
  274.                    - supports Commodity-Library 
  275.                    - red Eye's become white after a while of closed Eye's
  276.                    - removed  time-waste  when Eye's are  closed  (problems with
  277.                      Nemac IV)
  278. Vxx.4   20.02.1997 - Trancparent background (optional)!
  279.                    - Quickquit again included!
  280.                    - MagicEYE window is hindmost window
  281.                    - MagicEYE in WWW http://www.fh-augsburg.de/~krabbe/magiceye/
  282.                                              _   _
  283.                                             / \ / \
  284.                                             \#/ \#/
  285.            _              _                    _      _             _
  286.           /(\         :  /(\     _            /(\    /(\           /(\
  287.          /  \           /  \    /(\          /  \   /  \          /  \
  288.         /    \         /    \  /  \         /    \ /    \___     /    \
  289.        /      \       /      \/    \       /     //     ___ \   /      \
  290.       /        \     /              \     /     //     /\__\ \ /        \
  291.      /          \   /                \   /     //     / /   )//          \
  292.     /     /\     \ /     /\    /\     \ /     //     / /    \/     /\     \
  293.    /     /__\    //     / /\  / /\    //     //     / /______\    /__\     \
  294.   /     ____    //     / /  \/ / /   //     //     / / _     \\    ____     \
  295.  /     /\__/   //     / /    \/ /   //     / \    ( /\( \    /\\   \_  \     \
  296.  \    ( / (___/ \    ( /       (___/ \    ( / \    V  \\/   / / \___)\  )    /\
  297.   \    V   \__\/ \    V         \__\/ \    V   \    \__7   / /   \__\/ /    / /
  298.    \___/\         \___/\               \___/\   \_________/ /          \___/ /
  299.     \__\/  sMail:  \__\/     eMail:     \__\/    \________\/            \__\/
  300.                                                            _______  ___ _____
  301.   Christian Krapp     Christian.Krapp@A-City.De           / __//\ \/ /// __//
  302.   Hagenmähderstr.9                                       / _//   \  /// _//
  303. D-86391 Stadtbergen                                     / //__   / /// //__
  304.   (GERMANY)                                             \___//  /_// \___//
  305.                                 © 1995,1996,1997,1998,1999 by Christian Krapp
  306.                                                   Freigegeben als SHAREWARE
  307.  
  308. Vxx.5  01.07.1997  - Bug in Layer-Patch removed
  309.                    - Needs less cpu-time!
  310.                    - You can change the color of the eyelid, bloody eyes, pupils
  311.                      and eyes.
  312.                    - New effects:
  313.                      + eyelid can close independent form other lid,
  314.                      + angry, anxious and insult eyes,
  315.                      + Pupil look up and down.
  316.                      + different pupil-graphics:
  317.                        * normal
  318.                        * big pupil
  319.                        * cross pupil
  320.                        * amiga pupil
  321.                        * heart pupll
  322.                    - Disable the single effects.
  323.                    - Window can be moved
  324.                    - Needed ToolTypes implemented.
  325.                    - Additional configuration-file.
  326.                    - Removed a lot of bugs.
  327.  
  328. Vxx.6   28.11.1998 - Eyesize is now variable
  329.                      + different Graphicsets: 5, 13 and 26 Points
  330.                      + Effects uses now different sizes
  331.                    - Optimiert  (internal  Graphicset  removed,  configurations-
  332.                      file load),
  333.                    - Bug in DRAGPATCH removed.
  334.                    - Uses ENV:AmigaEYE/ for all configuration-files.
  335.                    - New effect: left-right asynchron.
  336.                    - Removed some bugs
  337.  
  338. V39.7   01.01.1999 - Integrated antialized version again
  339.                    - Integrated eyebrows (you can switch it off)
  340.                    - Pirate eyes
  341.                    - Eye glasses
  342.                    - New AmigaEYE-Size:  11 point (for 13-point  title font with
  343.                      eyebrows
  344.                    - Automatic sizing of eyes depending on title font
  345.                    - Left and right pupile can have different looking
  346.                    - New color-pupil and glassy-pupil
  347.                    - You can run now AmigaEYE more than once a time
  348.                    - Optimized a little bit
  349.                    - Removed a lot of bugs:
  350.                      + problem in ToolTypes
  351.                      + problem with library-loading
  352.                      + problem with behind-layer
  353.                      + Lock/UnlockPubScreen problem
  354.                      + memory-leak if screen is closed/opened
  355.                      + graphic-problem with cross-pupils
  356.                      + longstanding bug with CybergraphiX-Screens (15/16/24 Bit)
  357.                        and BACKGROUND option
  358.                      + MOVEABLE and BACKGROUND should now work together
  359.  
  360. --------------------------------------------------------------------------------
  361.